---
title: amountToHangul
---

import { Sandpack } from '@/components/Sandpack';
import { Callout } from 'nextra/components';

# amountToHangul

<Callout type="error" emoji="⚠️">
  Deprecated: 더 유연하게 사용 가능한 [`numberToHangul`](./numberToHangul)을 이용해 주세요.
</Callout>

숫자나 문자를 [국립국어원](https://ko.dict.naver.com/#/correct/korean/info?seq=602) 규칙의 한글 읽기 문자열로 변환합니다.

자세한 예시는 아래 Example을 참고하세요.

```typescript
function amountToHangul(amount: string | number): string;
```

## Examples

```tsx
amountToHangul('15,201,100'); // '일천오백이십만천백'
amountToHangul('120,030원'); // '일십이만삼십'
amountToHangul('12345.6789'); // '일만이천삼백사십오점육칠팔구'
amountToHangul(15_201_100); // '일천오백이십만천백'
```

## 사용해보기

<br />

<Sandpack>

```ts index.ts
import { amountToHangul } from 'es-hangul';

console.log(amountToHangul('15,201,100'));
```

</Sandpack>
